package com.rolerealm.dao;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.rolerealm.domain.entity.UserInteractionEntity;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;

/**
 * 用户行为数据访问接口
 * 
 * @author RoleRealm Team
 * @version 1.0.0
 */
@Mapper
public interface UserInteractionMapper extends BaseMapper<UserInteractionEntity> {

    /**
     * 根据用户ID和时间范围查询交互记录
     * 
     * @param userId 用户ID
     * @param startTime 开始时间
     * @return 交互记录列表
     */
    List<UserInteractionEntity> selectByUserIdAndTimeRange(@Param("userId") Long userId, @Param("startTime") LocalDateTime startTime);

    /**
     * 根据用户ID查询交互记录
     * 
     * @param userId 用户ID
     * @param limit 限制数量
     * @return 交互记录列表
     */
    List<UserInteractionEntity> selectByUserId(@Param("userId") Long userId, @Param("limit") Integer limit);

    /**
     * 根据角色ID查询交互记录
     * 
     * @param characterId 角色ID
     * @param limit 限制数量
     * @return 交互记录列表
     */
    List<UserInteractionEntity> selectByCharacterId(@Param("characterId") Long characterId, @Param("limit") Integer limit);

    /**
     * 统计用户对特定角色的交互次数
     * 
     * @param userId 用户ID
     * @param characterId 角色ID
     * @param interactionType 交互类型
     * @return 交互次数
     */
    Long countUserCharacterInteraction(@Param("userId") Long userId, @Param("characterId") Long characterId, @Param("interactionType") String interactionType);

    /**
     * 统计角色总交互次数
     * 
     * @param characterId 角色ID
     * @return 总交互次数
     */
    Long countCharacterInteractions(@Param("characterId") Long characterId);

    /**
     * 查询用户最近交互的角色ID列表
     * 
     * @param userId 用户ID
     * @param days 最近天数
     * @param limit 限制数量
     * @return 角色ID列表
     */
    List<Long> selectRecentCharacterIdsByUserId(@Param("userId") Long userId, @Param("days") Integer days, @Param("limit") Integer limit);

    /**
     * 查询与指定用户有相似交互行为的用户ID列表
     * 
     * @param userId 用户ID
     * @param limit 限制数量
     * @return 相似用户ID列表
     */
    List<Long> selectSimilarUserIds(@Param("userId") Long userId, @Param("limit") Integer limit);

    /**
     * 检查用户是否已收藏特定角色
     * 
     * @param userId 用户ID
     * @param characterId 角色ID
     * @param interactionType 交互类型
     * @return 存在记录数
     */
    int existsByUserAndCharacterAndType(@Param("userId") Long userId, @Param("characterId") Long characterId, @Param("interactionType") String interactionType);
}
